# 乐动掌控2.0 文档

```{admonition} 本文引用的文件
:class: note

- [index.rst](../../../products/ledong-v2/index.rst)
- [1_index.rst](../../../products/ledong-v2/1_hardware/1_index.rst)
- [1_2_Technical_parameters.rst](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)
- [1_3_IO.rst](../../../products/ledong-v2/1_hardware/1_3_IO.rst)
- [1_index.rst](../../../products/ledong-v2/3_examples/1_index.rst)
- [1_index.rst](../../../products/ledong-v2/4_xiaozhi/1_index.rst)
- [1_xiaozhi.rst](../../../products/ledong-v2/4_xiaozhi/1_xiaozhi.rst)
- [1_index.rst](../../../products/ledong-v2/5_api/1_index.rst)
- [1_index.rst](../../../products/ledong-v2/6_faq/1_index.rst)
- `board.json`
- `main.py`
- `boot.py`
```

## 产品概述
乐动掌控2.0（labplus_Ledong_v2）是基于ESP32-S3双核的高性能开源教学硬件，面向K12创客与AIoT教育场景。板载高清LCD彩屏、ES8388音频解码、QMI8658C六轴传感器、MMC5603磁力计、LTR-308光线传感器、双麦克风、RGB灯、实体与触摸按键、摄像头与电机接口，并内置MicroPython解释器，支持WiFi+蓝牙5通信，便于快速实现语音交互、传感采集、显示控制与物联网应用。

- 目标用户：中小学信息技术教师、学生、创客与教育机器人开发者
- 核心价值：开箱即用的AIoT学习平台；丰富的板载外设与扩展能力；完善的示例与API文档
- 适用场景：语音助手、智能小车、环境监测、人机交互、AI视觉入门、物联网原型开发

章节来源
- [index.rst:1-39](../../../products/ledong-v2/index.rst)

## 核心业务流程
围绕“输入—处理—输出”的闭环，典型流程如下：
- 语音交互：麦克风采集→音频编解码→小智AI或云端服务→播放反馈
- 传感与控制：传感器采样→数据处理→屏幕显示/蜂鸣提示/电机驱动
- 联网与IoT：WiFi连接→网络请求/消息上报→状态更新与可视化

```text
graph TB
A["用户/环境"] --> B["输入设备<br/>麦克风/按键/传感器"]
B --> C["MCU处理<br/>ESP32-S3 + MicroPython"]
C --> D["输出设备<br/>LCD/喇叭/RGB/电机"]
C --> E["网络服务<br/>WiFi/蓝牙/云端AI"]
E --> C
```

[本图为概念流程图，不直接映射具体源码文件]

## 功能模块清单
- 硬件模块
  - 音频：ES8388解码芯片与功放，支持录音、播放、TTS等
  - 运动感知：QMI8658C六轴（加速度计/陀螺仪），MMC5603磁力计
  - 环境感知：LTR-308数字光线传感器
  - 显示：ST7789 LCD彩屏
  - 交互：实体按键A/B、电容触摸P/Y/T/H/O/N、RGB灯、蜂鸣器
  - 视觉：30万像素摄像头（GC0328）
  - 扩展：多路HY2.0 4PIN拓展接口、I2C、UART、SPI、PWM、ADC
  - 电源：USB 5V或内置1200mAh锂电池供电
- 软件与工具
  - 编程软件：mPython IDE、Labplus 3、Mind+
  - 固件：基于ESP-IDF v5.x + MicroPython v1.24.1
  - 示例代码：基础IO、网络、传感器、音频、BLE、AI等
  - 小智AI：本地化部署的语音对话助手
  - API参考：TFT显示、MOTION、Pin/Button/Touch、wifi、music、audio等
  - C语言开发：ESP-IDF工程模板与板级配置
  - FAQ：常见问题与技术支持渠道

章节来源
- [1_2_Technical_parameters.rst:1-82](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)
- [1_index.rst:1-36](../../../products/ledong-v2/3_examples/1_index.rst)
- [1_index.rst:1-12](../../../products/ledong-v2/4_xiaozhi/1_index.rst)
- [1_index.rst:1-10](../../../products/ledong-v2/5_api/1_index.rst)
- [1_index.rst:1-22](../../../products/ledong-v2/6_faq/1_index.rst)

## 数据与状态
- 关键数据模型
  - 传感器数据：加速度/角速度/磁场强度/光线值/声音采样值
  - 显示数据：字符/图形/颜色/位图
  - 音频数据：PCM/编码流/录音文件
  - 网络数据：HTTP/MQTT/UDP报文
  - 设备状态：WiFi连接、BLE连接、电池电量、电机状态
- 关键状态流转
  - 音频链路：录音初始化→录制→存储/播放→释放
  - 显示链路：清屏→绘制→刷新
  - 传感器链路：初始化→采样→滤波/校准→输出
  - 网络链路：扫描→连接→认证→收发→断开
- 数据所有权边界
  - 板载传感器由MOTION/Pin等模块统一封装访问
  - 文件系统用于持久化录音、图片与配置
  - 网络模块负责对外通信，业务逻辑在应用层

章节来源
- [1_3_IO.rst:1-54](../../../products/ledong-v2/1_hardware/1_3_IO.rst)
- [1_2_Technical_parameters.rst:1-82](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)

## 关键约束与边界
- 硬件约束
  - 工作电压3.3V，最大工作电流约500mA，最大负载电流约1500mA
  - P4为光线传感器专用，P10为声音传感器专用，不可作为通用引脚使用
  - I2C总线与内部传感器共享，外部I2C设备需注意地址冲突
  - 摄像头占用多路GPIO，需避免与其他功能复用冲突
- 软件约束
  - 内存限制：PSRAM 8MB，Flash 16MB，注意大对象与缓存释放
  - 音频与显示同时运行时对CPU与带宽有较高要求
  - WiFi/蓝牙并发使用时需合理调度资源
- 集成边界
  - 小智AI依赖网络与音频链路，需确保麦克风与扬声器正常
  - BLE/GATT服务需遵循标准UUID与特性定义
  - 第三方扩展模块需匹配I2C/SPI/UART等资源

章节来源
- [1_2_Technical_parameters.rst:44-50](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)
- [1_3_IO.rst:1-54](../../../products/ledong-v2/1_hardware/1_3_IO.rst)
- `board.json:1-25`

## 附录：架构与数据流（图示）
```text
sequenceDiagram
participant U as "用户"
participant MIC as "麦克风"
participant CPU as "ESP32-S3"
participant AI as "小智AI/云端"
participant SPK as "扬声器"
participant LCD as "LCD"
U->>MIC : 说话
MIC-->>CPU : 音频采样
CPU->>AI : 语音识别/意图理解
AI-->>CPU : 回复文本/指令
CPU->>SPK : 语音合成播放
CPU->>LCD : 显示状态/结果
CPU-->>U : 反馈
```

[本图为概念序列图，不直接映射具体源码文件]

## 附录：示例与上手
- 快速体验
  - 通过mPython IDE将示例程序上传至乐动掌控2.0，验证按键、屏幕、声音、传感器等基础功能
  - 使用示例中的音频、网络、BLE、摄像头等模块进行进阶实验
- 推荐路径
  - basics：repl/io/lcd/buzz/buttons/touchpad/sound/light/accelerometer/gyroscope/wifi/udp/uart
  - advance：iot/random/timer/radio/i2c/thread/filesystem/ble
  - AI：AudioAI、Agent、ImageAI（摄像头）

章节来源
- [1_index.rst:1-36](../../../products/ledong-v2/3_examples/1_index.rst)
- `main.py:1-597`
- `boot.py:1-6`

## 附录：小智AI
- 简介：基于ESP32-S3的本地化语音对话助手，支持唤醒词检测、实时翻译、响应式交互
- 快速上手：提供免编译固件，烧录即可使用；具备多轮对话与情感化语音交流
- 开源信息：xiaozhi-esp32项目，降低AI开发门槛，助力边缘计算原型构建

章节来源
- [1_xiaozhi.rst:1-31](../../../products/ledong-v2/4_xiaozhi/1_xiaozhi.rst)

## 附录：API参考索引
- 显示：TFT_displayer（DispChar/DispChar_font/clear/show）
- 运动：MOTION（Accelerometer/Gyroscope/Magnetic）
- 引脚与交互：MPythonPin、Button、Touch
- 网络：wifi（connectWiFi/disconnectWiFi/enable_APWiFi）
- 音频与音乐：music、audio（录音/播放/音量/TTS）
- 无线：radio（发送/接收/配置）
- 扩展：BLE、摄像头、文件系统、MQTT等

章节来源
- [1_index.rst:1-10](../../../products/ledong-v2/5_api/1_index.rst)

## 附录：C语言开发
- 构建系统：ESP-IDF v5.x + CMake
- 板级配置：board.json定义特性与部署说明
- 工程入口：main.c与组件组织遵循ESP-IDF规范
- 建议：优先使用MicroPython快速原型，复杂算法或底层驱动采用C/ESP-IDF实现

章节来源
- `board.json:1-25`

## 附录：FAQ与技术支持
- 联系方式：论坛、QQ群、服务热线与服务时间
- 常见问题：可在FAQ页面查阅或提交问题获取帮助

章节来源
- [1_index.rst:1-22](../../../products/ledong-v2/6_faq/1_index.rst)